KSFC API 포털 참가 신청 안내

(한국증권금융, `23.4)

1. 네트워크 환경 구축

□ 투자자예탁금 API 서비스를 제공하는 『KSFC API 포털』 참가를 위해 네트워크 방화벽 설정을 위한 IP 정보 확인이 필요합니다.

❍ 네트워크는 기본적으로 자본시장 공동망(이하 K-NET)을 이용할 예정이며, 참가기관 IP 할당 신청 필요시 금융투자협회 담당자*를 통해 신청하시기 바랍니다.

* 담당자 연락처 : 02-2003-9059 lkj@kofia.or.kr

❍ 할당받은 IP정보를 참가 신청서<붙임1>를 통해 제출하시면 방화벽 설정과 함께 네트워크 환경 구축을 지원하도록 하겠습니다.

❍ 참가기관 네트워크 보안 정책에 따라 당사 API 테스트 서버 네트워크 연계 관련 작업 진행을 부탁드립니다.

네트워크 구분	서버 구분	IP	PORT
K-NET	테스트	<회신 예정>	<회신 예정>
	운영	<회신 예정>	<회신 예정>

□ REST API 아키텍처 방식의 투자자예탁금 API는 K-NET 네트워크에서 다음과 같이 자원(리소스)을 식별합니다.

분류	URI 계층 구조
OAuth 2.0 관련 API	<base path> / oauth / 2.0 / token
일반 API	<base path> / <version> / <resource>

- <base path> : http://XXX.XXX.XXX.XXX <회신 예정>

2. KSFC API 포털 웹페이지 안내

□ 『KSFC API 포털』 인터넷 웹페이지는 개발 가이드를 포함하여 서비스 전반에 대한 안내 및 관리 기능을 제공합니다.

네트워크 구분	URL
인터넷	https://apiportal.ksfc.co.kr

❍ 이용기관 담당자께서는 회원가입을 통해 개발가이드 조회 등 보다 다양한 서비스 이용이 가능하며, 테스트·운영 서버에 대한 API 신청은 관리자 계정*으로 변경 후 가능합니다.

* 참가 신청서 <붙임1>에 관리자 권한을 받고자 하는 분의 포털 ID (기관당    최대 2개) 기입을 부탁드립니다.

❍ 포털 웹페이지를 통한 API 신청을 위해서는 이용기관 담당자께서 접속하시는 PC의 공인 IP 정보(인터넷)가 필요합니다. 참가 신청서<붙임1>에 IP 정보(사무실 인터넷 공인 IP 대역)*를 정확히 기입하여 제출을 부탁드립니다.

* 이용기관 사무실 내 인터넷 접속 가능 PC에서 네이버 검색창에 “내 ip 확인” 검색

□ 네트워크 환경 구축 및 API 개발 테스트 지원

❍ 이용기관별 개발·테스트 일정에 따라 지원해 드리도록 하겠습니다. 대표 연락처에서 담당자의 담당 업무 및 연락처 확인 후 지원이  필요하신 분야 담당자에게 연락 부탁드립니다.

3. 조치 사항

□ “KSFC API 포털 참가 신청서”<붙임1> 제출을 부탁드립니다.

- 디지털금융부 이메일 : <dt_strategy@ksfc.co.kr>

□ 대표 연락처

소 속	담 당 업 무	연 락 처
디지털금융부	KSFC API 포털 총괄	02-3770-8289
IT부	네트워크 인프라 및 API 규격 / 인증 API	02-3770-8953
		02-3770-8909
	투자자예탁금 API	02-3770-1022
		02-3770-1021
자본시장금융부	투자자예탁금 업무 총괄	02-3770-8785

<붙임> KSFC API 포털 참가 신청서

붙임		KSFC API 포털 참가 신청서

법인명

○○ 증권

총괄부서

자금부, IT부

총괄책임자

(현업/IT)

(성명)홍길동(현업)

담당자

(현업/IT)

(성명)일지매(현업)

(연락처)02-XXXX-XXXX

(연락처)02-XXXX-XXXX

(이메일)abc@ksfc.co.kr

(이메일)ghi@ksfc.co.kr

(성명)김철수(IT)

(성명)안영미(IT)

(연락처)02-XXXX-XXXX

(연락처)02-XXXX-XXXX

(이메일)def@ksfc.co.kr

(이메일)jkl@ksfc.co.kr

추진현황

□ 투자자예탁금 API 프로젝트 개발 입찰 중

2. 추진계획

□ 프로젝트 시작 예정(8월)

□ 네트워크 환경구축 예정(8월)

□ 대외 연계 접속 테스트 예정(8월)

□ 단위·통합 테스트 예정(9~10월)

3. 네트워크

구 분	내 용
유형	□ K-NET	□ 일반 전용회선
운영 IP	□ Nat IP □ Real IP - IP :	□ Nat IP □ Real IP - IP :
개발 IP	□ Nat IP □ Real IP - IP :	□ Nat IP □ Real IP - IP :

※ K-NET 이용 시 금융투자협회와 IP 확인 필요

구 분	내 용
KSFC API 포털 웹페이지	□ 공인 IP 대역(사무실 인터넷 네트워크) - IP :

4. 관리자

권한 계정

□ (이메일) abc@ksfc.co.kr

□ (이메일) def@ksfc.co.kr

5. 기타

건의사항

□ (작성 요령)

1. 기울임 처리되어있는 부분 을 소속기관에 맞게 작성 부탁드립니다.

※ 특히, 4번 「관리자 권한 계정」은 해당란에 기입된 이메일 계정 ID

에만 회원가입 이후 관리자 권한을 부여하니, 정확히 기재해주세요.

(기관당 최대 2개까지 관리자 계정을 보유할 수 있습니다.)

※ 서비스 이용 중 관리자 계정 변경이 필요한 사정이 발생한 경우,

하단의 포털 관리자 이메일로 연락해주시면 됩니다.

2. 작성 완료된 참가 신청서를 스캔하여, 포털 관리자 이메일로 제출

부탁드립니다.

☞ 포털 관리자 이메일 : dt_strategy@ksfc.co.kr

3. 참가 신청서 접수가 완료되면, 포털 관리자가 당사의 네트워크 IP 및

Port의 정보가 담긴 참가 신청 안내를 이메일로 회신 드립니다.

4. 제출해주신 정보로 포털에 회원가입을 신청하시면, 포털 관리자가

승인절차를 진행하며, 가입 완료시 KSFC API 포털을 정식으로 이용

하실 수 있게 됩니다.

※ 이후의 포털 이용절차는 포털 웹사이트를 참고해주세요.